CM-2 and CM-200 
Installation Instructions for 
Prism Version 1.1 


This is the CM-2/CM-200 installation guide for Prism Version 1.1. Read it 
completely before attempting the installation. 

Note that this installation procedure is different from previous procedures; it 
now supports the installation of soft links. 


Planning the Installation 

General 

Perform the installation as superuser. 

You can run the installation from any directory to which you have write access 
as superuser. 

When answering any question during the installation, you can accept the 
default (which is indicated in square brackets) by simply pressing the Return 
key in response to the question. In addition, you can escape to a subshell at any 
time by entering ! (exclamation) in response to a question. 

In addition to installing a number of files, the Prism installation script needs to 
ensure that the file XKeysymDB exists on the user’s system and that it contains 
the correct OSF bindings required for Prism to work properly. Because of this, 
the installation procedure must be able to write into the X library directory. If 
for some reason the X library directory cannot be made writable, you can man¬ 
ually fix the XKeysymDB file by appending the contents of the XKeysymDB 
file that is shipped in the Prism support directory to the currently installed ver¬ 
sion of the file. 
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Choosing a Tape Drive 

The installation may be performed from either a local or a remote tape drive. 
You should decide on which type you will use. In general, a local tape drive is 
preferable. 

Next, find the name of the non-rewinding tape device that you will be using for 
the installation. On a Sun, the reel tape is often /dev/nrmt8, and the car¬ 
tridge tape is often /dLev/nrst8. If you are not sure of the device name for 
your tape drive, check with your system administrator. 

Last, if you have decided to use a remote tape drive, make sure that you have 
root access to the remote system by executing the following command on the 
system where Prism is to be installed: 

# rsh remoteJiostjiame date 

If you receive a “Permission denied” message, you need to add the name of 
your machine to the / . rhosts file on the remote machine. 


installation Components 

The entire installation (including optional components) uses about 10 Mbytes 
of disk space. Each component is described below. 


Table 1. Prism components. 


Component 

Size 

Prism driver 

3 Kb 

Prism support directory 

9.5 Mb (Sun); 8 Mb (VAX) 

Prism runtime libraries 

150 Kb (Sun); 50 Kb (VAX) 

Prism manual page 

3 Kb 

Prism sample program 

1 Kb 


Prism Driver 

We suggest that this component be placed in /usr/loc&l/bin. 
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Prism Support Directory 

This component contains the internal files required for Prism to work correctly. 
We recommend that it be placed in /usr/local/lib. NOTE: The app- 
defaults file for Prism is in the app-defaults subdirectory of this director}'. 


Prism Runtime Libraries 

We suggest that this component be placed in /usr/local/lib. (NOTE: In 
VAX installations, there is only one Prism runtime library.) 


Prism Manual Page 

We suggest that the man page be placed in the repository for CMost user man¬ 
ual pages, /usr/man/local/CMOST/roanl. 


Prism Sample Program 

Prism provides a sample program that users can work with in the on-line tuto¬ 
rial. We recommend that you place the examples directory in the directory 
/usr/cm/examples/. This will create the directory /usr/cm/exam- 
ples/prism. 


Reading the Tape 

As mentioned earlier, you can install Prism from either a local or remote tape 
drive. In either case, the first step is to read the installation script off the tape. 

To do this, first become superuser and change to the director}’ from which you 
will do the installation. If you are doing the installation from a remote tape 
drive, skip to the section “Reading a Remote Tape.” If you are using a local 
tape drive, continue to the next section. 
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Reading a Local Tape 

To unload the installation procedure from a local tape drive, issue the following 
commands: 

# xnt -f tapejdevice rew 

# xnfc -f tapejdevice fsf 

# tar xf tapejdevice 

where tapejdevice is the name of the non-rewinding tape drive that you are 
using for the installation. 

For example: 

# mt -f /dev/nrmtOh rew 

# mt -f /dev/nrmtOh fsf 

# tar xf /dev/nrmtOh 

You can now skip the section “Reading a Remote Tape,” below, and continue 
with the section “Installing Prism Version 1.1 Beta.” 


Reading a Remote Tape 

To unload the installation procedure from a remote tape drive, issue the follow¬ 
ing commands: 

# rsh remoteJiostjiame mt -f tapejdevice rew 

# rsh remote Jiostjiame mt -f tapejdevice fsf 

# rsh remote Jiostjiame dd if= tapejdevice lbs -bs I tar xpBf - 

where: 

remote Jiostjiame is the name of the machine with the tape drive. 

tapejdevice is the device name of the remote non-rewinding tape drive. 

bs is the blocksize to use when reading the tape. If you are read¬ 

ing from a reel (9-track) tape, then bs is 20b. If you are using 
a Sun cartridge, then bs is 126b. 

For example: 

# rsh cmns mt -f /dev/nrmtOh rew 

t rsh cmns mt -f /dev/nrmtOh fsf 

# rsh cmns dd if=/dev/nrmtOh lbs=2Ob | tar xpBf - 
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Installing Prism Version 1.1 

Issuing the Command 

To install Prism, issue this command: 
# ./install 1.1 


Answering the Questions 

First you will be asked a set of questions about the tape drive that you are 
using. Having gotten this far in the installation process, you should find the 
answers. The questions are listed below. 

Is this a remote installation? [n] 

Enter the name of the tapeserver host [no default] 

What is the name of your non-rewinding tape drive device? [/dev/nrst8] 
Is the distribution on a cartridge tape? [yj 

Next, you can elect to see the name of each file as it is extracted from the tape. 
If you want a detailed list of the files being installed, answer yes to this ques¬ 
tion: 

Should the files be extracted from the tape verbosely? [n] 

You will then be asked to make sure that the tape is mounted and ready. Don’t 
be alarmed that the procedure is asking for Tape 1; the Prism installation uses 
only one tape. 

Is tape 1 mounted and ready to go? [Type carriage return when ready] 

The next set of questions take care of installing each of the components of 
Prism. After each question is answered, the installation script will unload that 
component into the location you specify. 

Where do you want to put the Prism Driver [/usr/local/bin]? 

Where do you want to put the Prism Support Directory [/usr/local/lib]? 

Where do you want to put the Prism Runtime Libraries [/usr/local/lib]? 

(NOTE: In VAX installations, there is only one Prism runtime library.) 

Where do you want to put the Prism Manual Page 
[/usr/local/man/CMOST/manl]? 

Where do you want to put the Prism Examples Directory? 

„ / u sr/ cm./ex amp res]? 
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Everything has now been read from the tape. The installation procedure then 
asks: 

Where is the X library directory on this machine? [/usr/lib/Xll]? 

The next questions asked by the procedure are used to customize the installa¬ 
tion to the environment at your site. The first three of these questions will ask 
for a pathname that is valid from a user’s point of view. The pathnames that 
you specify in this section might be different from those that you specified 
when you unloaded the tape. This might be the case, for example, if you are 
installing Prism onto a server that will be exporting the Prism directories to cli¬ 
ent machines from which users will be running Prism. In this case, the 
pathname used to access a directory on the server may be different from the 
pathname used to access that same server directory from the client. 

Note that your responses to these questions do not make soft links. If you are 
going to use links, respond to this set of questions with the locations of the 
installed software (that is, what the soft links should point at), not the locations 
of the soft links that are going to be installed. 

The questions are shown below. 

Where would a user find the Prism Support Directory [/usr/local/lib]? 

Where would a user find the Prism Runtime Libraries [/usr/local/lib]? 

Where would a user find the Prism Driver [/usr/local/bin]? 

Where would a user find the Prism Manual Page 

[/usr/local/man/CMOST/manl] ? 

Where would a user find the X library directory [/usr/lib/Xll]? 

Next, the installation script asks about soft links: 

Do you want to install soft links [no]? 

If you answer yes, the script asks: 

In what directory should the driver link be created [/usr/local/bin]? 
In what directory should the library links be created 
[/usr/local/lib]? 

In what directory should the man page link be created 
[/usr/local/man/CMOST/manl]? 

It then continues: 

The Prism 'email' command allows users to submit bug reports from 
within Prism. Enter a valid e-mail address to which these messages 
should be sent. If your site has a local Applications Engineer, the 
AE's e-mail address should be given, otherwise the e-mail should be 
directed to Customer Support at Thinking Machines (csg6think.com). 
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Enter a valid e-mail address for Prism bug reports [no__default]? 

With each software release Thinking Machines will now be sending an 
ASCII bug-update file that lists fixed bugs and outstanding bugs for 
Prism, We will also be sending monthly updates to this file. 

The bug-update file for this release is called prism-1.1.bugupdate. 

Where would you like to install the bug-update file [/usr/cm/doc]? 

After you have answered these questions, the installation procedure will build 
the on-line documentation database and then ranlib the Prism runtime library. 

This completes the basic installation of Prism. 


Verifying the Installation 

We suggest that you verify the installation by starting Prism and making sure 
that the help system and the on-line documentation system work. To start 
Prism, issue these commands (substituting the name of your own workstation 
for workstation): 

% rehash 

% setenv DISPLAY workstation: 0 
% prism 

The rehash may be necessary to update the shell’s hash tables to see the newly 
installed prism command. After Prism starts up, pull down the Help menu 
and click on any selection to make sure the help files are available. Pull down 
the Doc menu and click on Online Doc. Submit a topic (for example, “attach¬ 
ing”) and make sure that the documentation is available. If there is a problem 
with on-line documentation, see below. 

It may be the case, however, that you will be able to obtain on-line documen¬ 
tation but other users will not; this will happen if Prism is installed onto a 
server that exports Prism to other machines, and the pathname to the support 
directory is different on the server and the client. See below for a workaround. 


If Online Documentation Isn’t Working 

You may find that on-line documentation isn’t working. In the Xwais window 
that appears when you click on Online Doc, you may see the message: 
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The following database is not available: ... 

And in the xterni from which you started Prism, you may see the message: 

can't open the word hash file ... 

This problem can occur if the Prism support directory was installed into a file 
system that is mounted on the installation system via the Sun automounter. 

The workaround is to log in to the machine that exports the file system on 
which the Prism support directory resides and manually build the on-line doc¬ 
umentation database by issuing these commands: 

# cd prism-support-directory/online 

# ./waisindex -d time-documentation -r raw-text 



